home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / dsm206.arc / DOSAMATC.TXT < prev    next >
Text File  |  1986-01-12  |  42KB  |  1,164 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                     DOSamatictm - Release 2.06
  17.  
  18.               User Guide, Reference, and License Agreement
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.               Copyright (c) 1985 by Marin Pacific Software
  34.  
  35.                            All Rights Reserved
  36.  
  37.  
  38.                           November 6, 1985
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                       Your License Agreement
  61.  
  62.  
  63. DOSamatic is the sole property of Marin Pacific Software Company.  You 
  64. are granted a limited, non-exclusive license to use one copy of 
  65. DOSamatic on a single machine, and to make copies for other users to 
  66. evaluate.
  67.  
  68. You may not:
  69.  
  70.     o   Remove copyright and other notices from the program and/or the 
  71.         documentation which are placed there by Marin Pacific Software 
  72.         Company.
  73.  
  74.     o   Re-sell the program for any charge or "disk fee"
  75.  
  76.     o   Make any representations on behalf of Marin Pacific Software.
  77.  
  78. Marin Pacific Software Company makes no warranty, express or implied, 
  79. as to the suitability of DOSamatic for any particular purpose.  You 
  80. must determine that yourself.  In addition, you should understand that 
  81. using a program of this type on an IBM PC or compatible has inherent 
  82. risks and that you may inadvertently damage or destroy valuable 
  83. programs or data.  Marin Pacific Software expressly declines to assume 
  84. liability for any use of this program by you, and your use of DOSamatic 
  85. constitutes your agreement to hold us blameless.
  86.  
  87. If trial users wish to use DOSamatic on a regular basis, they may 
  88. register by sending a check or money order for $39.00 to:
  89.  
  90.                  Marin Pacific Software Company
  91.                  1001 Bridgeway, Suite 514
  92.                  Sausalito, CA 94965
  93.  
  94. Please enclose your name and address, any serial number which may 
  95. appear on your trial copy, and any comments you may have.  Marin 
  96. Pacific will send the latest version of DOSamatic ( we are improving it 
  97. all the time ) and the DOSamatic user guide.  In addition, for 
  98. individuals, when other users register copies with your serial number, 
  99. we will send you a check for 10 % of the amount they send us, if it is 
  100. no less than $39.00.
  101.  
  102. Registered users may upgrade to new versions of DOSamatic at any time 
  103. for a small charge required to cover diskette, handling and postage. 
  104. (currently $5.00 ).
  105.  
  106. Multiple-use site licenses for corporations are available at 
  107. significant discounts from single copy prices, and customization is 
  108. possible for high-volume purchasers.  Note that the 10% commission does 
  109. not apply to copies purchased by companies.
  110.  
  111.  
  112.  DOSamatic User Guide         November 6, 1985              Page #
  113.                                                                       
  114.  
  115.  
  116.                            Table of Contents
  117.  
  118.     1. Introduction.......................................    3
  119.  
  120.     2. System Requirements................................    4
  121.  
  122.     3. The Program Disk...................................    4
  123.  
  124.     4. Getting Started....................................    5
  125.  
  126.     5. Defaults...........................................    5
  127.  
  128.     6. The Basic Panels...................................    5
  129.          The Information Panel............................    5
  130.          The Drive Selection Panel........................    6
  131.          The Directory Selection Panel....................    6
  132.          The File Selection Panel.........................    7
  133.          Comparison with DOS commands.....................    7
  134.  
  135.     7. Panel Commands.....................................    8
  136.          Special Keys.....................................    8
  137.               The Cursor keys.............................    8
  138.               The [ENTER] key.............................    8
  139.               The [ESCAPE] key............................    8
  140.               The [INSERT] key............................    8
  141.               The [DELETE] key............................    9
  142.               The [F1] = [HELP] key.......................    9
  143.               The [F2] = [REFRESH] key....................    9
  144.               The [F40] = [SWITCH] key....................    9
  145.          Main Menu........................................   10
  146.               Screen Colors...............................   10
  147.               Executing DOS Commands......................   10
  148.               Exiting DOSamatic...........................   10
  149.               Using a File Mask...........................   10
  150.               Setting the Hot Key.........................   10
  151.               Searching for a File........................   10
  152.               Show/Hide Date/Time/Size....................   10
  153.               Show Normal/Hidden Files....................   11
  154.               Sorting the File Display....................   11
  155.               Sound On/Off................................   11
  156.               Suppressing Flicker/Snow....................   11
  157.               Labeling a Volume...........................   11
  158.  
  159.          File Menu........................................   12
  160.               Attributes..................................   12
  161.               Browsing ASCII Files........................   12
  162.               Browsing Binary Files.......................   12
  163.               Using Your Debug Program....................   12
  164.               Using Your Edit Program.....................   12
  165.               Executing a BAT, COM, or EXE file...........   12
  166.               Printing a File.............................   12
  167.               Renaming a File.............................   12
  168.  
  169.  
  170.  
  171.                                                                       
  172.  
  173.  
  174.     8. Quick Reference....................................   13
  175.          Table of Keystrokes..............................   13
  176.          How to End DOSamatic.............................   13
  177.  
  178.     9. Using the Task-Switching Feature...................   14
  179.          How to Use It....................................   14
  180.          Technical Details................................   15
  181.          Compatible Software..............................   15
  182.          Cautions.........................................   17
  183.          Encouragements...................................   17
  184.  
  185.     10.A Word on Versions...............................   18
  186.          Known Nasty Bugs and how to fix them.............   19
  187.               Task-Switching Under PC-DOS 3.x.............   19
  188.               PC-FILE goes BEEP...........................   20
  189.               PC-DOS 3.x Users Destroy Directories........   20
  190.          Why Bugs Happen and What We Do About Them........   20
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.                             1. Introduction
  231.  
  232. DOSamatic is a powerful tool that helps you get the most out of your 
  233. IBM Personal Computer or compatible.  It combines a point and press 
  234. user interface with a powerful multi-tasking facility allowing you to 
  235. run several programs at the same time.
  236.  
  237. DOSamatic is not copy-protected.  You are encouraged to give copies to 
  238. your friends for their use.  If you find the program useful you should 
  239. send a check for $39.00 payable to :
  240.  
  241.  
  242.  
  243.                          Marin Pacific Software
  244.                         1001 Bridgeway, Suite 514
  245.                           Sausalito, CA 94965
  246.  
  247.  
  248. If there is a serial number on the program, please include it along 
  249. with your name and mailing address.
  250.  
  251. We will register you as a DOSamatic user, and send you the latest 
  252. version of the program, along with the latest user guide.  Please send 
  253. us any suggestions you may have for enhancements or improvements in 
  254. DOSamatic.
  255.  
  256. Besides being a nice thing to do, registering brings you several 
  257. benefits.  When another user registers a copy with your serial number, 
  258. we'll send you a check for 10 percent of the amount they send us.  
  259. We'll also keep you on our mailing list so that we can send you other 
  260. products we develop for your examination at no cost.
  261.  
  262. Even if you decide not to register, please do not attempt to delete the 
  263. copyright and order information messages.  We don't copy protect any of 
  264. our packages, and we depend upon you to respect our efforts.
  265.  
  266. Corporate Users Note: Site licenses for multiple copies are available 
  267. at reasonable terms.
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.                         2. System Requirements
  286.  
  287. DOSamatic will run on the IBM PC, PC/XT, PC/AT, 3270PC, and most 
  288. compatibles including the Compaqs and the Data General DG/1.  Minimum 
  289. requirements are :
  290.  
  291.     128 KB of memory ( although up to 640 KB is useful for running 
  292.     multiple tasks ).
  293.  
  294.     PC DOS 2.0, 2.1, 3.0, 3.1, or MS-DOS 2.11. ( Version 2.04 now 
  295.     supports ALL post 2.0 versions of DOS - previous releases may not 
  296.     work properly with DOS 3.0 or 3.1 ).
  297.  
  298.     One diskette drive.
  299.  
  300.     Either a color or a monochrome monitor with 80 column display.
  301.  
  302.  
  303. Note that DOSamatic determines how much memory you actually have, the 
  304. number of disk drives ( including hard disks and RAM disks ) available, 
  305. and the type of monitor you are using.
  306.  
  307.  
  308.                           3. The Program Disk
  309.  
  310. If you receive DOSamatic from Marin Pacific Software or from a friend, 
  311. there should be three files on the diskette :
  312.  
  313.     DOSAMATC.COM - The DOSamatic Program
  314.  
  315.     DOSAMATC.DOC - This manual in ASCII text format.
  316.  
  317.     DOSAMATC.HLP - File containing HELP screens used by DOSamatic.
  318.  
  319. If you receive your program disk from us, there may be other files on 
  320. the disk to help you install DOSamatic.  Just use the DOS TYPE command 
  321. to display the contents of the file named READ.ME to find out what is 
  322. on your program disk.
  323.  
  324. Unlike many copy-protected programs, the DOSamatic program disk may be 
  325. freely copied.  You can move the program, help and manual files onto 
  326. another floppy, or a hard disk.  See the section on starting DOSamatic 
  327. for more details.
  328.  
  329. NOTE: It is your responsibility to make backup copies of the program 
  330. disk we send you.  Never use your program disk without making such a 
  331. backup copy.
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.                           4. Getting Started
  341.  
  342. Starting DOSamatic is easy.  Simply place the program diskette in the 
  343. current default disk drive ( not necessary for hard disk users ), type 
  344. "DOSAMATC", and press [ENTER].
  345.  
  346. DOSamatic will display the Marin Pacific Software logo screen, and then 
  347. the license agreement under which you may use the program.  Please do 
  348. not try to alter the program to suppress these messages.
  349.  
  350. Finally, pressing any key will make DOSamatic display its main screen 
  351. with the Information, Drive Selection, Directory Selection, and File 
  352. Selection Panels.
  353.  
  354.  
  355.                               5.Defaults
  356.  
  357. DOSamatic lets you specify a number of default settings at startup 
  358. using the DOS SET environment command.  These are:
  359.  
  360.     SET COMSPEC=filename   Command processor to use for executing DOS 
  361.                            commands, e.g. C:\COMMAND.COM
  362.  
  363.     SET DSD=filename       Debug program to use, e.g. C:\DOS\DEBUG.COM
  364.  
  365.     SET DSE=filename       Edit program to use, e.g. C:\EDLIN.COM
  366.  
  367.     SET DSH=filename       Help file to use, e.g. C:\DOSAMATC.HLP
  368.  
  369.     SET DSV=monitor        monitor=MONO for no color, =COLOR+ for 
  370.                            non-IBM Color Graphics boards
  371.  
  372. Issue these commands before starting DOSamatic.
  373.  
  374.  
  375.                           6. The Basic Panels
  376.  
  377. The Information Panel
  378.  
  379. After starting DOSamatic, you will see a full screen display - the main 
  380. DOSamatic screen.  The screen consists of an Information Panel at the 
  381. top which shows you:
  382.  
  383.     o   The default disk drive, the volume label of the drive, and the 
  384.         current directory for that drive,
  385.  
  386.     o   Disk space information including total KB ( kilobytes ) on the 
  387.         diskette, the KB available ( free ), the available KB as a 
  388.         percent of the total, and the number of files displayed along 
  389.         with the KB of space they occupy,
  390.  
  391.  
  392.  
  393.  
  394.     o   Total RAM ( random access memory ) on your PC, and the RAM 
  395.         available for running additional programs,
  396.  
  397.     o   The version of DOS you are using,
  398.  
  399.     o   The current date and time.
  400.  
  401.     o   The number of tasks ( programs ) you are currently running, 
  402.         including DOSamatic, and
  403.  
  404.     o   The status of the keyboard shift keys ( top right corner ).  
  405.         Press the Scroll Lock key several times to see how this 
  406.         feature works.
  407.  
  408. Below the Information Panel are the three Selection Screens.
  409.  
  410.  
  411. The Drive Selection Panel
  412.  
  413. In the panel labelled "Drives" is a list of the available drive letters 
  414. on your system.  Use the cursor keys to move the large reverse video 
  415. cursor bar onto a drive letter, and then press [ENTER].  The selected 
  416. drive letter will become the DOS default drive, and the Information, 
  417. Directory, Selection, and File Selection Panels will be refreshed to 
  418. show information about the drive you have selected.
  419.  
  420. If you change the diskette in a drive, then you will need to select 
  421. that drive again to read the new diskette.
  422.  
  423. The Directory Selection Panel
  424.  
  425. The panel labelled "Directories" shows you a list of all the 
  426. directories on your diskette which are accessible from the directory 
  427. that is currently active.  To view a different directory, place the 
  428. cursor bar on the desired directory and press [ENTER].  Note the two 
  429. special directory entries, <root> and <parent>, which enable you to 
  430. jump directly to the root directory, or back one step in the current 
  431. directory chain.
  432.  
  433. If there are too many directories to fit in the window, then the window 
  434. will scroll up and down as you move the cursor keys off the ends.
  435.  
  436. When the cursor bar is in the Directory Selection Panel, pressing 
  437. [INSERT] creates a new directory, and DOSamatic will prompt you for its 
  438. name and extension.  Press [ESCAPE] if you change your mind about 
  439. creating the new directory.
  440.  
  441. Pressing [DELETE] when the cursor bar is placed on a directory name 
  442. will remove that directory ( DOSamatic asks you to verify that you 
  443. really want to do that ).
  444.  
  445.  
  446.  
  447.  
  448.  
  449. The File Selection Panel
  450.  
  451. The panel labelled "Files" shows you a list of all the files in the 
  452. current directory on the default disk.  Placing the cursor bar on a 
  453. file name and pressing [ENTER] opens a pull-down menu at the right side 
  454. of the screen from which you may select operations to be performed on 
  455. the file.
  456.  
  457. If there are too many files to fit in the window, then the window will 
  458. scroll up and down as you move the cursor keys off the ends.
  459.  
  460. When the cursor bar is in the File Selection Panel, pressing [INSERT] 
  461. creates a new file, and DOSamatic will prompt you for its name and 
  462. extension.  Press [ESCAPE] if you change your mind about creating the 
  463. new file.
  464.  
  465. Pressing [DELETE] when the cursor bar is placed on a file name will 
  466. erase that file ( DOSamatic does check to make sure you want to do that 
  467. ).  If the file has special attributes, you may need to activate the 
  468. Attribute Selection Panel and make changes before attempting to erase 
  469. the file.
  470.  
  471. Comparison with DOS Commands
  472.  
  473. Note that the Directory and File Selection Panels show you the same 
  474. information that the DOS DIR command would, except that all the files 
  475. in the current directory are available for your viewing.
  476.  
  477. The Information Panel gives you the same information that the DOS CD, 
  478. CHKDSK, DATE, TIME, VOL, and VER commands would.
  479.  
  480. The use of the [INSERT] and [DELETE] keys replaces use of the DOS 
  481. MKDIR, RMDIR, and ERASE commands.
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.                            7. Panel Commands
  506.  
  507. Special Keys
  508.  
  509. By using only a few keys, plus pull-down menus, DOSamatic lets you 
  510. perform complex functions without the need to memorize complex 
  511. keystroke sequences.  These are:
  512.  
  513.  
  514. The Cursor Keys              These keys let you move the cursor bar 
  515.                             within and between windows.  On the IBM PC 
  516.                             keyboard they are arranged as:
  517.  
  518.                             [HOME]     [UP  ]    [PAGE UP  ]
  519.  
  520.                             [LEFT]     [    ]    [RIGHT    ]
  521.  
  522.                             [END ]     [DOWN]    [PAGE DOWN]
  523.  
  524. Within any active panel, the [HOME], [UP], [PAGE UP], [END], [DOWN], 
  525. and  [PAGE DOWN] keys work as you would expect to move the cursor bar 
  526. within the panel.  For the Drive, Directory, and File Selection Panels, 
  527. [LEFT] and [RIGHT] move the bar between panels, but have no effect for 
  528. other panels.
  529.  
  530. When you are prompted for input lines, [LEFT] and [RIGHT] work as you 
  531. would expect, [HOME] moves you to the beginning of the input line, 
  532. [END] moves you to the end, and [CTRL]+[END] will delete all characters 
  533. from the current position to the end of the input line.
  534.  
  535. The [ENTER] key              This key is used to select a drive, 
  536.                             directory, file, or panel option, or to 
  537.                             signal the end of an input line.  Think of 
  538.                             it as the Activator key.
  539.  
  540. The [ESCAPE] key             This key functions as a Deactivator key 
  541.                             which lets you jump from the current panel 
  542.                             to a previous one.  It lets you shift 
  543.                             between the Main Menu Panel and the Drive, 
  544.                             Directory, and File Selection Panels.
  545.  
  546. The [INSERT] key             This key is used in two ways.  First, it 
  547.                             can be used to create new files or make 
  548.                             new directories if you press it while the 
  549.                             cursor bar is in the Files or Directories 
  550.                             panel.  Second, it is used when providing 
  551.                             responses to program questions to decide 
  552.                             whether characters are overwritten or 
  553.                             inserted.
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560. The [DELETE] key             This key is used to erase files or remove 
  561.                             directories.  Simply place the cursor bar 
  562.                             on the object to be deleted and press 
  563.                             [DELETE].  DOSamatic will make sure that 
  564.                             this is what you want to do.
  565.  
  566. The [F1] = [HELP] key        Will cause a context-sensitive help screen 
  567.                             explaining what your current options are 
  568.                             to be displayed.  See the section on 
  569.                             Defaults for an explanation of how to tell 
  570.                             DOSamatic where on your system the help 
  571.                             file is located.
  572.  
  573. The [F2] = [REFRESH] key     This key will refresh the display screen 
  574.                             if it ever gets damaged.  This feature may 
  575.                             be removed in future versions of DOSamatic 
  576.                             as the program becomes more resistant to 
  577.                             problems caused by sub-tasks.
  578.  
  579. The [F40] = [SWITCH] key     This default "hot key" lets you jump from 
  580.                             one active task to another.  You may reset 
  581.                             it to another key combination.  If no 
  582.                             subtasks are active, [F40] has no effect.
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615. The Main Menu Panel
  616.  
  617. If the cursor bar is in the Drive Selection, Directory Selection, or 
  618. File Selection panels, pressing [ESCAPE] activates the Main Menu 
  619. Panel.  This pull-down menu lets you execute a number of system 
  620. functions.  Move the cursor bar to one of the functions and press 
  621. [ENTER] to activate it.  Pressing [ESCAPE] will return you to the panel 
  622. you were in before you activated the Main Menu Panel.
  623.  
  624. The Main Menu Panel functions are :
  625.  
  626.     Turn Color On/Off  Lets you switch color on and off.  Monochrome 
  627.                        monitors with graphics adapters usually look 
  628.                        best with color off.  See the section on 
  629.                        Defaults.
  630.  
  631.     DOS Commands       Pressing this key lets you issue any legal DOS 
  632.                        command as long as sufficient memory is 
  633.                        available.  You are prompted for the command at 
  634.                        the bottom of the screen.
  635.  
  636.     Exit               Use this selection to end DOSamatic and return 
  637.                        to DOS.  You can't do this if any sub-tasks are 
  638.                        still running.
  639.  
  640.     Filemask           Upon selecting this option, you are prompted 
  641.                        for a file mask, and DOSamatic will then 
  642.                        display only those files matching the mask.  
  643.                        For example, entering *.COM will result in the 
  644.                        display of only those files with extension of 
  645.                        COM.
  646.  
  647.     Set Hot Key        If you select this item, DOSamatic displays the 
  648.                        current "hot key" used to jump among programs 
  649.                        and asks you to press the key(s) you wish to 
  650.                        use instead.
  651.  
  652.     Search             Selecting this item you are prompted for a 
  653.                        filename and extension, and DOSamatic will 
  654.                        search all directories on the default drive for 
  655.                        that file.  Using *.EXE, for example, DOSamatic 
  656.                        will find all files with an extension of EXE.
  657.  
  658.     Show Date/Time     This selection switches the display of file 
  659.                        date, time, and KB occupied on and off.
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.     Show Hidden Files  This item switches on and off the display of 
  671.                        files with the special DOS attributes of SYSTEM 
  672.                        and/or HIDDEN.  For example, the files 
  673.                        IBMBIO.COM and IBMDOS.COM are system and hidden 
  674.                        files present on the DOS system disk.  You will 
  675.                        need to have DOSamatic re-read the current 
  676.                        drive before you will see any change in the 
  677.                        displayed list of files.
  678.  
  679.     Sort               Selecting this item opens a sort pull-down menu 
  680.                        in which you specify the sort key, and the 
  681.                        order ( ascending or descending ).  The file  
  682.                        display changes when you leave the Main Menu 
  683.                        Panel.
  684.  
  685.     Sound On/Off       Switches on and off the use of sound cues with 
  686.                        DOSamatic.
  687.  
  688.     Suppress Flicker   For IBM Color Graphics Adaptors, writing 
  689.                        directly to the screen memory in alphanumeric 
  690.                        mode causes "snow".  To prevent this the video 
  691.                        is shut off momentarily, causing display 
  692.                        flicker.  Many other adapters do not have this 
  693.                        problem, and display flicker is reduced by 
  694.                        selecting this item.  See the Defaults section.
  695.  
  696.     Volume Label       Selecting this option allows you to create or 
  697.                        change an 11-character volume label for the 
  698.                        diskette in the default drive.
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725. The File Menu Panel
  726.  
  727. Pressing [ENTER] when the cursor bar is in the File Selection Panel 
  728. opens the File Menu Panel pull-down menu.  This menu shows you a number 
  729. of actions which you can perform upon the selected file when you press 
  730. the [ENTER] key.  You can return to the File Selection Panel at any 
  731. time by pressing [ESCAPE].  The following functions can be performed on 
  732. the selected file:
  733.  
  734.     Attributes      Selecting this item will open the Attributes 
  735.                     Panel, which displays the files attributes and 
  736.                     lets you modify them if desired.  For example, you 
  737.                     can hide files or make them read-only.
  738.  
  739.     Browse ASCII    Displays the contents of the selected file, 
  740.                     assuming that it is in ASCII text format.
  741.  
  742.     Browse Binary   Provides both an ASCII and a hexadecimal display 
  743.                     of file contents for files in non-text format.
  744.  
  745.     Copy            Copies the selected file to another file.
  746.  
  747.     Debug           Activates the debugger program you specified to 
  748.                     debug the selected file.  See the section on 
  749.                     Defaults.
  750.  
  751.     Edit            Activates the editor program you specified to edit 
  752.                     the selected file.  See the section on Defaults.
  753.  
  754.     Execute         The most powerful capability of DOSamatic, allows 
  755.                     you to execute any other program in available 
  756.                     memory.  The selected file must have an extension 
  757.                     of BAT, COM, or EXE.  BAT files receive all 
  758.                     available memory, but COM or EXE files can be 
  759.                     restricted to run in a portion of memory.
  760.  
  761.                     You are prompted for the amount of memory in KB to 
  762.                     be used.  You are also asked if this is a graphics 
  763.                     program, which requires additional storage for a 
  764.                     screen buffer.
  765.  
  766.                     Once your selected program starts, you can jump 
  767.                     immediately back to DOSamatic by pressing the 
  768.                     current hot key.  If you have memory left, you can 
  769.                     start other programs ( up to 7 additional programs 
  770.                     ) and switch among them using the [SWITCH] key.
  771.  
  772.     Print           Prints the selected file to LPT1:.  Use this for 
  773.                     small files for which you want a quick copy.
  774.  
  775.     Rename          Lets you rename the selected file.
  776.  
  777.  
  778.  
  779.  
  780.                     8. Quick Reference to DOSamatic
  781.  
  782. Active Panel            Key        Action
  783.  
  784. Drive Selection         [ENTER]    Select Drive
  785.                        [ESCAPE]   Activate Main Menu
  786.                        [LEFT]     Go to File Selection Panel
  787.                        [RIGHT]    Go to Directory Selection Panel
  788.  
  789. Directory Selection     [DELETE]   Remove selected directory
  790.                        [ENTER]    Select Directory
  791.                        [ESCAPE]   Activate Main Menu
  792.                        [INSERT]   Make a new directory
  793.                        [LEFT]     Go to Drive Selection Panel
  794.                        [RIGHT]    Go to File Selection Panel
  795.  
  796. File Selection          [DELETE]   Erase selected file
  797.                        [ENTER]    Activate File Menu Panel
  798.                        [ESCAPE]   Activate Main Menu
  799.                        [INSERT]   Create a new file
  800.                        [LEFT]     Go to Directory Selection Panel
  801.                        [RIGHT]    Go to Drive Selection Panel
  802.  
  803. Main Menu               [ENTER]    Perform indicated action
  804.                        [ESCAPE]   Deactivate Main Menu Panel
  805.  
  806. File Menu               [ENTER]    Perform indicated action
  807.                        [ESCAPE]   Return to File Selection Panel
  808.  
  809. Sort Selection          [ENTER]    Use indicated sort criteria
  810.                        [ESCAPE]   Return to Main Menu Panel
  811.  
  812. Attribute Menu          [ENTER]    Make indicated attribute change
  813.                        [ESCAPE]   Return to File Menu Panel
  814.  
  815. ** ALL PANELS **        [F1]       Help ( context sensitive ).
  816.                        [F2]       Refresh Screen
  817.                        [F40]      Jump to another task if one is 
  818.                                   active.  Another key can be 
  819.                                   substituted for [F40].
  820.  
  821. In all panels the cursor keys not mentioned above will move the cursor 
  822. bar up and down within the panel.
  823.  
  824. Ending DOSamatic
  825.  
  826. Press the [ESCAPE] key until the Main Menu Panel is displayed, place 
  827. the cursor bar on EXIT, and press [ENTER].
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.                   9. Using the Multi-Tasking Feature
  836.  
  837. One of the most useful capabilities of DOSamatic is the ability to run 
  838. from 1 to 7 other programs simultaneously, switching between them by 
  839. pressing a single "hot key".
  840.  
  841. How to Use It
  842.  
  843. Previously, you learned how to execute programs from DOSamatic by 
  844. placing the cursor bar on the program name, pressing [ENTER] to 
  845. activate the File Menu, and then placing the cursor on the EXECUTE 
  846. option and pressing [ENTER] again.  DOSamatic asks you for any required 
  847. parameters, and then requests the amount of memory in which you wish 
  848. the program to run.  If the available memory is 322 KB, say, you might 
  849. wish to have your program use 128 KB.
  850.  
  851. DOSamatic will then ask if your program displays graphics on the video 
  852. screen.  If you reply by typing [Y], DOSamatic reserves an additional 
  853. 16 KB of memory to preserve the graphics screen when you start 
  854. switching among programs.  Otherwise, DOSamatic reserves 4 KB of memory 
  855. for your program screen.
  856.  
  857. After your program starts, you can return to DOSamatic at any time by 
  858. pressing [F40], i.e. pressing the [ALT] key and the [F10] key 
  859. simultaneously.  This key combination was selected because very few 
  860. programs actually use it for anything ( although there are some ), and 
  861. because it is easy to hit with the left hand on the standard keyboard.
  862.  
  863. You can now switch at will between DOSamatic and your other program 
  864. simply by pressing [F40] = [ALT] + [F10].  If you did not use all the 
  865. available memory for your program, you can load additional programs 
  866. from DOSamatic as you did before, and use the hot key to switch among 
  867. them all.  The Task field at the top of the display tracks how many 
  868. programs you have running.
  869.  
  870. Note that you can reset the [SWITCH] key to a combination other than 
  871. [F40].
  872.  
  873. NOTE: DOSamatic does not perform true multi-tasking - instead it keeps 
  874. a number of application programs in memory and SUSPENDS execution of 
  875. all but the current active program.  We are beginning to work on a 
  876. communications utility which will allow background upload and download 
  877. of files using XMODEM, but it will be some time before this capability 
  878. is available.
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889. Technical Details
  890.  
  891. DOSamatic performs its task switching by intercepting program calls to 
  892. the BIOS and DOS keyboard handlers.  It is always checking for the hot 
  893. key, and when pressed goes into action.  DOSamatic also monitors some 
  894. of the BIOS video monitor calls, since the BIOS does not preserve all 
  895. video information.  Finally, DOSamatic intercepts calls to the DOS 
  896. memory control functions to limit program requests for memory.
  897.  
  898. Programs that bypass the keyboard services and manipulate the hardware 
  899. directly will not let you jump back to DOSamatic.  However, pop-up 
  900. applications like Sidekick (tm) and SuperKey (tm) can be installed 
  901. successfully before you start DOSamatic and can be used during your 
  902. DOSamatic session.
  903.  
  904. Certain programs manipulate PC hardware directly, so DOSamatic has no 
  905. way of knowing what they are doing.  This is especially true of 
  906. graphics.  See the notes on Lotus 123 (tm) and SuperCalc 3 (tm).
  907.  
  908. Compatible Software
  909.  
  910. The following programs have been tested by various users with DOSamatic 
  911. and have behaved in a reasonable manner.  If there is a comment, it 
  912. reflects any incompatibilities which may arise.  No comments are made 
  913. when there is no known compatibility problem.
  914.  
  915. Program           Vendor            Comments
  916.  
  917. BASIC             IBM/Microsoft     BASIC is not re-entrant so you 
  918.                                    cannot run more than one copy at a 
  919.                                    time.
  920. CrossTalk         MicroStuf
  921.  
  922. DOS 2.x, 3.X      IBM/Microsoft     When loading a secondary copy of 
  923.                                    the command processor COMMAND.COM, 
  924.                                    it must be given all remaining 
  925.                                    memory.  If you are loading this, 
  926.                                    load it last. ( May not apply to 
  927.                                    DOS 3.1 ).
  928. DEBUG             IBM/Microsoft
  929.  
  930. Displaywrite 2    IBM               DW 2 reserves all available memory 
  931.                                    when it loads.
  932.  
  933. DOSamatic         Marin Pacific     You can run one or more copies of 
  934.                                    DOSamatic as tasks, but don't try 
  935.                                    to run any sub-tasks from the 
  936.                                    copies without changing the hot key.
  937. EDLIN             IBM/Microsoft
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944. Leading Edge WP   Leading Edge      Can't jump out of this.
  945.  
  946. Lotus 123         Lotus DC          Lotus manipulates video hardware 
  947.                                    directly, so the cursor often 
  948.                                    blinks in the wrong place, although 
  949.                                    this stops as soon as you hit any 
  950.                                    keystroke.  If you jump when a 
  951.                                    graph is displayed you get a mess, 
  952.                                    press any key in Lotus to recover.
  953.  
  954. MultiMate         MultiMate Corp.   [F40] sometimes has a meaning - 
  955.                                    change the hot key or press 
  956.                                    [ESCAPE] after switching back into 
  957.                                    MultiMate if there is a problem.
  958. Norton Utilities  Peter Norton
  959.  
  960. PC-File 3.0       Jim Button        Works w/DOSamatic 2.05 & later.
  961.  
  962. PC-Talk III       Headlands Press   Note that while you will be online 
  963.                                    if you jump out of PC-TALK, you can 
  964.                                    not have an upload/download 
  965.                                    continue while you work on 
  966.                                    something else at the current time.
  967.  
  968. Sidekick          Borland Int'l     Start it before DOSamatic.
  969.  
  970. SIM3278           SIMWARE
  971.  
  972. Smartcom II       Hayes             Can't jump out of this.
  973.  
  974. SuperCalc 3       Sorcim/IUS        The border color on color monitors 
  975.                                    and the graphics colors are not 
  976.                                    preserved, although you can switch 
  977.                                    while a graph is displayed.
  978.  
  979. SuperKey          Borland Int'l     Start it before DOSamatic.
  980.  
  981. Symphony          Lotus DC
  982.  
  983. Turbo Pascal      Borland Int'l     Change the hot key from the default 
  984.                                    setting as it is interpreted as a 
  985.                                    Quit instruction.
  986. Volkswriter       Lifetree          
  987.  
  988. Word Microsoft    Word may or may not be a graphics program, your 
  989.                  choice.
  990.  
  991. Wordstar          MicroPro Int'l
  992.  
  993. XYWrite           XYQuest           Can't jump out of this.
  994.  
  995.  
  996.  
  997.  
  998.  
  999. Helpful Hints
  1000.  
  1001. DOSamatic can help you do lots of interesting things, especially when 
  1002. used with other programs.  Some of the useful ways to use it are:
  1003.  
  1004.     o   Use it to clean up your diskettes by checking directories, 
  1005.         browsing files to see what is in them, and deleting unneeded 
  1006.         files with the [DELETE] key.
  1007.  
  1008.     o   Use the Search command to look for files on a hard disk when 
  1009.         you can't remember what directory they are in.  Search is also 
  1010.         useful to check for duplicate files in different directories.
  1011.  
  1012.     o   Use it with application programs as a smart "front end".  
  1013.         DOSamatic provides directory switching and other features for 
  1014.         programs lacking these conveniences.
  1015.  
  1016.     o   DOSamatic enhances the value of SuperKey, a Borland 
  1017.         International product, which has a "cut and paste" capability. 
  1018.         You can use SuperKey in combination with DOSamatic to move 
  1019.         data from a spreadsheet into a word processor.
  1020.  
  1021. Cautions
  1022.  
  1023. There are problems whenever you try to implement multi-tasking on a 
  1024. machine that is not really designed for it.  These occur mainly because 
  1025. DOSamatic has no control over the programs you execute.  Two things you 
  1026. must absolutely avoid, however, are :
  1027.  
  1028.     o   Never attempt to run COMMAND.COM ( the DOS command processor ) 
  1029.         in less than the total remaining memory.  The system will hang 
  1030.         in an unrecoverable error.  So if you are going to run a 
  1031.         number of programs as tasks, including a second copy of DOS, 
  1032.         start all the others before you start up COMMAND.COM, and give 
  1033.         COMMAND.COM all the remaining memory.
  1034.  
  1035.     o   Be extremely careful when you end a program.  Always end 
  1036.         programs in the reverse of the order in which you start them.  
  1037.         If you start A, B, and C in that order, you must end them in 
  1038.         the order C, B, A. Failing to do this will generally lead to 
  1039.         an unrecoverable error and the big red switch.
  1040.  
  1041. In addition, DOSamatic can start programs which read the keyboard 
  1042. hardware directly, like Smartcom II, XYwrite,  and Leading Edge Word 
  1043. Processor, but you won't be able to jump out of them with the hot key.
  1044.  
  1045. Encouragements
  1046.  
  1047. We can't possibly test all the programs which you might want to run as 
  1048. DOSamatic tasks.  Most programs will run just fine, however, and we 
  1049. would be pleased to hear of your experiences.  Just drop us a note at 
  1050. our mailing address and we'll make sure to include any interesting 
  1051. comments which you may have in future editions of this manual.
  1052.  
  1053.  
  1054.                         10. A Word On Versions
  1055.  
  1056.  
  1057. There have been 1 major release and 6 minor releases of DOSamatic in 
  1058. 1985.  These are:
  1059.  
  1060.     2.00         The original - rough and ready, suitable for DOS 2.0 
  1061.                  and 2.1,
  1062.  
  1063.     2.01         Fancier menus - more features
  1064.  
  1065.     2.02         Implemented using Turbo Pascal version 3.00 ( yes, 
  1066.                  its written in PASCAL and some assembler ) = smaller 
  1067.                  code size
  1068.  
  1069.     2.03         Minor errors cleaned up - more ESCing possible - 
  1070.                  uploaded to CompuServe
  1071.  
  1072.     2.04         Does task-switching correctly for DOS versions 3.0 
  1073.                  and 3.1 ( and presumably some versions of MS-DOS )
  1074.  
  1075.     2.05         Works correctly with programs like PC-FILE 3.0 which 
  1076.                  use DOS IO calls 6 and 7,
  1077.  
  1078.     2.06         Corrects a nasty bug ( see below ) which affects 
  1079.                  users of PC-DOS 3.x, and presumably some versions of 
  1080.                  MS-DOS.
  1081.  
  1082.     3.00         You are going to like this one - but its not ready 
  1083.                  yet.  In line with our policy of being reasonable, 
  1084.                  ALL registered users of previous versions will get a 
  1085.                  free copy of this one.  ETA December 1985.
  1086.  
  1087. Known Nasty Bugs and How to Fix Them
  1088.  
  1089. There are bugs in various versions of DOSamatic, some annoying, some 
  1090. dangerous, all of them interesting as programming exercises and as 
  1091. views into DOS internals.
  1092.  
  1093. Task-Switching for PC-DOS 3.x, MS-DOS ???
  1094.  
  1095. When DOS 3.0 was released, IBM/Microsoft changed the way the program 
  1096. loader ( DOS call 4B ) determines how much memory is available.  Since 
  1097. DOSamatic was developed under PC-DOS 2.1, it could no longer control 
  1098. the requests for memory.  Presumably, this also happened to MS-DOS at 
  1099. some time.  If you have this problem, you need DOSamatic release 2.04 
  1100. or later.
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109. PC-FILE Goes BEEP
  1110.  
  1111. User found that loading PC-FILE under DOSamatic resulted in a 
  1112. continuous beeping noise.  This error is somewhat subtle.  We assumed 
  1113. (incorrectly, ignorantly ) that interrupt 21H, the DOS function call 
  1114. interrupt, WAS an interrupt.  It is not, since it does not always 
  1115. restore flag values upon return.  This made function call 6 appear to 
  1116. return a bogus character to PC-FILE, since DOSamatic restored the flags 
  1117. register upon return from a DOS call.  This was fixed in version 2.05.
  1118.  
  1119. DOS 3.x Users Destroy Directories
  1120.  
  1121. We found out about this the hard way - erasing an entire directory 
  1122. containing 40 pages of manuals we were about to deliver to one of our 
  1123. consulting clients.  The bug works like this - when you delete a file 
  1124. or directory using the [DEL] key, it's window entry is replaced by the 
  1125. characters '** erased **'.  Under DOS 2.x, if you then pressed [DEL] 
  1126. again while the cursor bar was on this file, nothing would happen.  
  1127. Under version 3.x, you guessed it, EVERYTHING in the directory gets 
  1128. erased if you unhappily press the 'Y' key in response to the prompt.
  1129.  
  1130. DOSamatic uses DOS function call 13H to erase a file - the behavior of 
  1131. this DOS function has clearly changed from version 2 to version 3.  Is 
  1132. this our fault?  Who knows, but we certainly suffered because of it.  
  1133. In any event users of PC-DOS 3.x, and some versions of MS-DOS, will 
  1134. need DOSamatic 2.06 to prevent this unfortunate occurrence.  Users of 
  1135. DOS 2.x are almost certainly OK - but you should try a test with a 
  1136. floppy with ONLY junk on it and see what happens.
  1137.  
  1138. Why Bugs Happen and What We Do About Them
  1139.  
  1140. Bugs happen for interesting reasons - misunderstanding, changes in the 
  1141. environment a program runs in, bad planning.  The situation with 
  1142. DOSamatic is especially problematic - we are attempting to provide some 
  1143. powerful tools, and powerful tools are always a two-edged sword.  The 
  1144. old argument about PL/1 being TOO powerful for programmers comes to 
  1145. mind - our preference is for powerful tools and knowledge about 
  1146. difficulties.
  1147.  
  1148. When we confirm that a bug exists, we fix it and then try to let people 
  1149. know about it.  Confirming that bugs exist can be quite difficult since 
  1150. we may not have enough information/equipment to replicate it.  We do 
  1151. try, however, and we do try to let people know about problems.  We are 
  1152. not in the business of fooling people about our products.  If it 
  1153. doesn't work the way you like, we'll refund your registration fee (that 
  1154. is, if you have registered).
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163. f it 
  1164. doesn't work